文件系统操作

在Node.js中，文件系统操作是非常常见的需求。无论是读取配置文件、写入日志，还是处理用户上传的文件，文件系统操作都是不可或缺的一部分。本教程将详细介绍如何在Node.js中进行文件系统操作，包括文件的读取、写入、删除、重命名等操作。

1. 文件系统模块（fs）简介

Node.js提供了fs模块，用于与文件系统进行交互。fs模块包含了大量的方法，可以用于同步和异步操作文件系统。

1.1 同步与异步操作

• 同步操作：同步操作会阻塞代码的执行，直到操作完成。同步操作的方法名通常以Sync结尾。
• 异步操作：异步操作不会阻塞代码的执行，通常通过回调函数或Promise来处理操作结果。

1.2 导入fs模块

在使用fs模块之前，需要先导入它：

const fs = require('fs');

2. 读取文件

2.1 异步读取文件

使用fs.readFile方法可以异步读取文件内容。该方法接受三个参数：文件路径、编码（可选）和回调函数。

fs.readFile('example.txt', 'utf8', (err, data) => {
    if (err) {
        return console.error('读取文件失败:', err);
    }
    console.log('文件内容:', data);
});

2.2 同步读取文件

使用fs.readFileSync方法可以同步读取文件内容。该方法接受两个参数：文件路径和编码（可选）。

try {
    const data = fs.readFileSync('example.txt', 'utf8');
    console.log('文件内容:', data);
} catch (err) {
    console.error('读取文件失败:', err);
}

3. 写入文件

3.1 异步写入文件

使用fs.writeFile方法可以异步写入文件内容。该方法接受三个参数：文件路径、写入内容和回调函数。

fs.writeFile('output.txt', 'Hello, Node.js!', (err) => {
    if (err) {
        return console.error('写入文件失败:', err);
    }
    console.log('文件写入成功');
});

3.2 同步写入文件

使用fs.writeFileSync方法可以同步写入文件内容。该方法接受两个参数：文件路径和写入内容。

try {
    fs.writeFileSync('output.txt', 'Hello, Node.js!');
    console.log('文件写入成功');
} catch (err) {
    console.error('写入文件失败:', err);
}

4. 删除文件

4.1 异步删除文件

使用fs.unlink方法可以异步删除文件。该方法接受两个参数：文件路径和回调函数。

fs.unlink('output.txt', (err) => {
    if (err) {
        return console.error('删除文件失败:', err);
    }
    console.log('文件删除成功');
});

4.2 同步删除文件

使用fs.unlinkSync方法可以同步删除文件。该方法接受一个参数：文件路径。

try {
    fs.unlinkSync('output.txt');
    console.log('文件删除成功');
} catch (err) {
    console.error('删除文件失败:', err);
}

5. 重命名文件

5.1 异步重命名文件

使用fs.rename方法可以异步重命名文件。该方法接受三个参数：旧文件路径、新文件路径和回调函数。

fs.rename('example.txt', 'new_example.txt', (err) => {
    if (err) {
        return console.error('重命名文件失败:', err);
    }
    console.log('文件重命名成功');
});

5.2 同步重命名文件

使用fs.renameSync方法可以同步重命名文件。该方法接受两个参数：旧文件路径和新文件路径。

try {
    fs.renameSync('example.txt', 'new_example.txt');
    console.log('文件重命名成功');
} catch (err) {
    console.error('重命名文件失败:', err);
}

6. 实践练习

6.1 练习1：读取并写入文件

编写一个程序，读取input.txt文件的内容，并将内容写入output.txt文件。

const fs = require('fs');

fs.readFile('input.txt', 'utf8', (err, data) => {
    if (err) {
        return console.error('读取文件失败:', err);
    }
    fs.writeFile('output.txt', data, (err) => {
        if (err) {
            return console.error('写入文件失败:', err);
        }
        console.log('文件写入成功');
    });
});

6.2 练习2：删除并重命名文件

编写一个程序，删除output.txt文件，并将new_example.txt重命名为example.txt。

const fs = require('fs');

fs.unlink('output.txt', (err) => {
    if (err) {
        return console.error('删除文件失败:', err);
    }
    console.log('文件删除成功');

    fs.rename('new_example.txt', 'example.txt', (err) => {
        if (err) {
            return console.error('重命名文件失败:', err);
        }
        console.log('文件重命名成功');
    });
});

7. 总结

通过本教程，你已经学习了如何在Node.js中进行文件系统操作，包括文件的读取、写入、删除和重命名。这些操作是构建复杂应用程序的基础，掌握它们将帮助你更好地处理文件相关的任务。

在实际开发中，建议优先使用异步操作，以避免阻塞主线程。同时，合理处理错误，确保程序的健壮性。

继续探索fs模块的其他方法，如创建目录、读取目录内容等，进一步提升你的文件系统操作能力。